SetAxisPosition
設定軸的目標位置。
語法
KsError SetAxisPosition(
int Index,
double Position
);
參數
Index:軸的索引。索引以零為起點;別名將影響此參數。
Position:軸的目標位置(使用者單位)。
回傳值
如果此函式執行成功,會回傳 errNoError
,否則會傳回錯誤碼。如需更多有關錯誤碼的資訊,請參閱 KsError 清單。
備註
- 此函式僅可在直接位置 (Direct Position)、PID 速度(PID Velocity) 及 PID 扭矩 (PID Torque) 控制模式中使用,其中此函式為設定軸目標位置的唯一函式。
- 當模數軸啟用時,模數值會套用至輸入位置。為了避免命令跳躍問題,軸將使用最短路徑來更新目標位置。例如,若模數值為 360,且輸入位置為 350,則軸會向負方向移動 10°。
範例
複製
KsError nRet = SetAxisPosition(0, 5000);
使用需求
RT | Win32 | |
---|---|---|
最低支援版本 | 4.0 | 4.0 |
標頭檔 | ksmotion.h | ksmotion.h |
程式庫 | KsApi_Rtss.lib | KsApi.lib |
參見